UCSD
Section: User Commands (1)
Index
Return to Main Contents
BSD mandoc
UCSD P-system 0.3
NAME
ucsd
- a P-code interpreter
SYNOPSIS
ucsd
[-a
]
[-g
]
[-V
]
[-x
]
-words
[-b batch-file
]
[-n SYSTEM-name
]
[-t trace-file
]
[-w volume-file
]
[-r volume-file
]
[-f volume-file
]
...
DESCRIPTION
This is the second public release of my P-code interpreter. It does
allow to run Apple Pascal (an ancient programming environment) on
todays computer systems. Although I did many improvements to this code
after my first release, it still is experimental code.
OPTIONS
The following options are accepted by
ucsd
- -a
-
execute the system in Apple compatibility mode.
In Apple compatibility mode, the P-system is initialized using the
same addresses as the original Apple][ P-system.
- -g
-
Enter P-code debug mode.
- -V
-
prints the version number and exits
- -x
-
Start an
xterm
for CONSOLE: and SYSTERM:.
Especially useful when using the debugger and its messages are output
to stdout/stderr.
- -b batch-file
-
Starts the system in batch mode.
Input is read from
batch-file
output is written to stdout
(unless
-x
is used).
if '-' is specified as
batch-file
stdin is used.
- -w volume-file
-
Uses
volume-file
for I/O on disk volumes in
read-write
mode.
- -r volume-file
-
Uses
volume-file
for I/O on disk volumes in
read-only
mode.
- -f volume-file
-
Uses
volume-file
for I/O on disk volumes in
forget-changes
mode, which discards all changes to
the volume, when exiting
ucsd
- -n SYSTEM-name
-
Uses
SYSTEM-name
instead of SYSTEM.PASCAL. In contrast to the original Apple system,
SYSTEM.PASCAL is found on any of the volumes.
- -t trace-file
-
Write the P-instructions executed to
trace-file
This recorded instructions can be compared to a recodring made on an
Apple][-emulator.
If '-' is specified as
trace-file
the data is written to stdout.
EXAMPLES
I usually start
ucsd
with
work.svol
as #4: in read-write mode and
system.svol
as #5: in read-only mode.
ucsd -w work.svol -r system.svol
To use the original Apple Pascal images, APPLE1: on #4:, APPLE2: on #5:
and APPLE3: on #9: you can execute
ucsd -w apple1.dsk -r apple2.dsk -r apple3.dsk
DISK IMAGES
You can make your own set of system disk images (mine are called
work.svol
and
system.svol )
To create a 1024 block volume in a file
my.svol
execute
dd if=/dev/zero of=my.svol bs=512 count=1024
After you have booted the P-system with your system volumes along with
the new volume, you can use the F(ilers Z(ero command to create an
empty directory on your volume.
I put the following files on my volumes:
WORK:
SYSTEM.MISCINFO 1 7-Nov-84 6 192 Datafile
SYSTEM.LIBRARY 28 7-Nov-84 7 512 Datafile
< UNUSED > 989 35
2/2 files <listed/in dir>, 35 blocks used, 989 unused, 989 in largest
SYSTEM:
SYSTEM.PASCAL 44 3-Sep-85 6 512 Codefile
SYSTEM.FILER 30 3-Sep-85 50 512 Codefile
SYSTEM.EDITOR 50 3-Sep-85 80 512 Codefile
SYSTEM.SYNTAX 12 1-Jul-85 130 512 Textfile
SYSTEM.COMPILER 78 3-Sep-85 142 512 Codefile
SYSTEM.LINKER 25 3-Sep-85 220 512 Codefile
SYSTEM.ASSMBLER 50 3-Sep-85 245 512 Codefile
6502.OPCODES 2 20-Dec-78 295 208 Datafile
6502.ERRORS 7 25-Dec-83 297 498 Datafile
LIBRARY.CODE 8 3-Sep-85 304 512 Codefile
LIBMAP.CODE 11 3-Sep-85 312 512 Codefile
... more stuff
You will note, there is no
SYSTEM.APPLE
and no
SYSTEM.CHARSET
while
SYSTEM.PASCAL
is on the second volume. This P-code interpreter does look for
SYSTEM.PASCAL
on all volumes available, so it does not have to be located on the
system volume.
Only
SYSTEM.LIBRARY , SYSTEM.MISCINFO
and
SYSTEM.WRK.=
are stored on the system volume.
DEBUGGER COMMANDS
- p
-
Print evaluation stack
- d [from [to
]
]
-
Dump memory in HEX and ASCII
- l
[SegProc
-
]
- Disassemble P-code
- t
-
Dump call stack including local variable and arguments
- v
-
Dump local variable area of the current procedure/function
- g
-
Go (start execution)
- n
-
Execute next instruction,
do not trace subroutines.
- f
-
finish current procedure/function,
execution stops at the first instruction after returning.
- r
-
Show registers
- q
-
Quit interpreter
SEE ALSO
svolio(1),
svolcvt(1),
-
Apple Pascal Operating System Reference Manual
1980
Appendix A/B
Architecture/Operation of the P-machine
The UCSD P-System Museum
http://www.threedee.com/jcm/psystem/index.html
HISTORY
The first P-system (version I.3), written by
An Roger T. Sumner,
was released by UCSD in August 1977.
In 1980, Apple Computers released its Apple Pascal,
based on UCSD Pascal version II.
AVAILABILITY
http://www.klebsch.de/
AUTHOR
An Mario Klebsch
< mario@klebsch.de
BUGS
Lots of functions still missing, e.g. native functions of the Apple
Pascal System (UNIT APPLESTUFF).
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- DISK IMAGES
-
- DEBUGGER COMMANDS
-
- SEE ALSO
-
- HISTORY
-
- AVAILABILITY
-
- AUTHOR
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 13:30:35 GMT, January 13, 2023